SUPERNOVA STRUCTURAL TRANSITION PIPELINE
========================================

Folder Purpose
--------------
This folder contains the complete UNNS structural analysis pipeline for
Type Ia supernova light-curve transition analysis.

The objective is NOT merely photometric analysis.

The purpose is to investigate whether explosive astrophysical systems
exhibit universal admissibility-collapse geometries inside the UNNS
Substrate framework.

The analysis focuses on:

    • raw observable structure
    • Δmag transition structure
    • curvature transition structure
    • time-resolved margin behavior
    • admissibility/percolation regimes
    • heavy-tail organization
    • structural fragmentation dynamics

------------------------------------------------------------
THEORETICAL CONTEXT
------------------------------------------------------------

The major discovery of this branch is:

    Raw observables may hide realizability structure.

The project demonstrated that:

    raw magnitude ladders
        → HARD_FRAGMENTATION

while:

    Δmag ladders
        → FULL_PERCOLATION

and:

    curvature ladders
        → FULL_PERCOLATION

This implies:

    structural transition geometry becomes visible only after
    observable-layer transformation.

This is one of the central emerging ideas of the UNNS
Structural Transition Geometry program.

------------------------------------------------------------
FOLDER CONTENTS
------------------------------------------------------------

1. processed_lightcurve.csv
---------------------------
Preprocessed supernova light-curve dataset.

Contains:
    • time
    • magnitude
    • cleaned observational series

This is the primary input for ladder generation.

------------------------------------------------------------

2. ladder_raw.txt
-----------------
Raw magnitude ladder.

Represents direct observational state-space structure.

Typical behavior:
    • fragmented
    • weak admissibility coherence
    • low structural persistence

Used as:
    • baseline comparison class

------------------------------------------------------------

3. ladder_dmag.txt
------------------
Δmag ladder.

Represents:
    successive magnitude transitions

Constructed as:

    Δmag(i) = mag(i+1) - mag(i)

This ladder exposed strong:
    • FULL_PERCOLATION
    • heavy-tail persistence
    • admissibility saturation

This became the primary supernova structural signature.

------------------------------------------------------------

4. ladder_curvature.txt
-----------------------
Curvature ladder.

Represents second-order structural transitions.

Constructed from:
    local curvature / second-difference geometry

This ladder often produces the strongest:
    • coherent admissibility structure
    • global structural persistence
    • transition saturation signatures

------------------------------------------------------------

5. build_dmag_structural_ladder.py
----------------------------------
Primary ladder construction script.

Generates:
    • ladder_raw.txt
    • ladder_dmag.txt
    • ladder_curvature.txt

from:

    processed_lightcurve.csv

------------------------------------------------------------

6. curvature_diagnostics.csv
-----------------------------
Diagnostic curvature statistics.

Used to:
    • inspect transition geometry
    • validate curvature extraction
    • identify instability regions

------------------------------------------------------------

7. dmag_diagnostics.csv
-----------------------
Diagnostic Δmag statistics.

Used for:
    • transition distribution analysis
    • tail inspection
    • admissibility variation studies

------------------------------------------------------------

8. curvature_diagnostics_*.zip
------------------------------
Archived curvature diagnostic package.

Contains:
    • plots
    • intermediate outputs
    • structural summaries

------------------------------------------------------------

9. struc_perc_output/
---------------------
STRUC_PERC results.

Contains:
    • FULL_PERCOLATION classifications
    • GIANT_COMPONENT analysis
    • TAIL_FRAGMENTATION diagnostics
    • giant ratios
    • component structure

This folder is one of the key scientific outputs.

------------------------------------------------------------

10. ladder_raw_*.zip
--------------------
Archived raw ladder package.

Used for:
    • reproducibility
    • transfer
    • historical comparison

------------------------------------------------------------

11. time_resolved_margin_pipeline.py
------------------------------------
Sliding-window structural transition analysis.

Purpose:
    detect local admissibility transitions over time.

Pipeline logic:

    processed_lightcurve
        →
    sliding windows
        →
    local ladders
        →
    STRUC_PERC
        →
    κ(t), fragmentation(t), admissibility(t)

This script enables:

    • transition localization
    • collapse timing analysis
    • structural migration tracking
    • dynamic admissibility evolution

------------------------------------------------------------
PIPELINE OVERVIEW
------------------------------------------------------------

STEP 1
------
Prepare light curve:

    processed_lightcurve.csv

STEP 2
------
Generate structural ladders:

    python build_dmag_structural_ladder.py

Outputs:
    • ladder_raw.txt
    • ladder_dmag.txt
    • ladder_curvature.txt

STEP 3
------
Run STRUC_PERC on ladders.

STEP 4
------
Inspect:

    struc_perc_output/

STEP 5
------
Run time-resolved analysis:

    python time_resolved_margin_pipeline.py

------------------------------------------------------------
EXPECTED STRUCTURAL RESULTS
------------------------------------------------------------

RAW LADDER
-----------
Typical:
    • HARD_FRAGMENTATION
    • weak global coherence

Meaning:
    raw observable alone is insufficient.

------------------------------------------------------------

ΔMAG LADDER
------------
Typical:
    • FULL_PERCOLATION
    • strong tail dominance
    • coherent collapse geometry

Meaning:
    transition observables reveal realizability structure.

------------------------------------------------------------

CURVATURE LADDER
----------------
Typical:
    • FULL_PERCOLATION
    • extreme admissibility persistence
    • saturation-like collapse geometry

Meaning:
    second-order structural observables may expose
    the deepest admissibility organization.

------------------------------------------------------------
SCIENTIFIC SIGNIFICANCE
------------------------------------------------------------

This folder forms one of the foundational empirical branches of:

    UNNS Structural Transition Geometry

The supernova branch demonstrates:

    • observable-layer dependence
    • admissibility saturation
    • coherent heavy-tail organization
    • transition-space realizability geometry

It also provides one of the strongest current examples of:

    coherent explosive admissibility collapse.

------------------------------------------------------------
CURRENT STATUS
------------------------------------------------------------

Status:
    ACTIVE / FOUNDATIONAL

Role inside broader UNNS project:
    astrophysical transition reference branch

Connected branches:
    • seismic admissibility analysis
    • NK nuclear explosion analysis
    • Voyager transition geometry
    • CERN interaction topology
    • κ-evolution collapse tracking

------------------------------------------------------------
END
------------------------------------------------------------